gdk: Small documentation fixes

Make sure gdk_event_get_seat shows up.

stack: Cosmetic documentation fixes

Fix parameter mismatches.

bitset: Cosmetic documentation changes

docs: Remove ancient version information

We treat 4.0 as a new era.

multiselection: Update docs

Remove information that is no longer true. GtkMultiSelection
is persistent across sorting changes since 3d8b6f6b799499cca02.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2160

docs: Migration guide additions

builder: Documentation tweaks

Don't use no-longer-existing enums as examples,
and drop the +.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2159

Update Kazakh translation

Update Kazakh translation

gtk-demo: Drop an unused object

The main ui file was still creating a tree store,
but we've switched everything over to use list models.

builder: Warn about dropped objects

Use GTK_DEBUG=builder-objects to make GtkBuilder warn
if a named object from a ui files doesn't get claimed
by gtk_builder_get_object(). This is useful for finding
dead wood in .ui files.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

Closes #2897 and #2898

See merge request GNOME/gtk!2158

listitem: Correct the docs

gtk-demo: Improve formatting in the color demo

Properly align and format the numbers in the size
dropdown.

text: Support reverse selection

Take ordering of cursor_position and selection_bound
into account when copying text to the clipboard, and
ensure that both orders work the same.

Fixes: #2898

text: Update action enabled state correctly

Take the editable property into account when updating
the emoji.insert action state, and update the action
when it changes.

Fixes: #2897

shortcutcontroller: Add some debug spew

This helps in debugging event routing and keyboard
shortcut issues.

widget: Fix an oversight

g_message comes with a builtin newline, don't add one
to the message.

Merge branch 'matthiasc/for-master' into 'master'

Adwaita: Fix block cursors in spinbuttons

Closes #2871

See merge request GNOME/gtk!2156

Adwaita: Fix block cursors in spinbuttons

Fix block cursors in vertical spinbuttons with Adwaita.

Fixes: #2871

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

Closes #2869

See merge request GNOME/gtk!2155

docs: Add css docs to entries

The various entries were missing the semi-standard
"CSS Nodes" section in their long descriptions. Add
them.

text: Be more selective when selecting on focus-in

We don't want to select on focus-in when the focus
comes from a child. The case where this does harm
is when you activate copy or paste actions from the
context menu. We close the menu before triggering the
action, and if that causes the text in the entry to
be selected, unexpected things happen, since the action
applies to the current selection.

Fixes: #2869

Revert "text: Avoid creating a PangoAttrList we don't need"

This reverts commit 67c26650280ba64ff1c0318be8d848e9563ddb21.

The splicing we do here has the important side-effect
of shifting the preedit attributes to the right position.
Without it, we end up always underlining the first chars
in the entry, regardless where the preedit happens.

text: Handle key events in the target phase

This makes sure that we do actual key input right
in the middle between all the capture and bubble
event controllers, and are not dependent on the
ordering of those controllers.

The bug that triggered this change was that the
shortcut for activation (Enter) was getting triggered
before the key input, causing Ctrl-Shift-u hex
to stop working, since it never received the enter
to commit the sequence.

widget: Add a debug message for consumed key events

Run the application with GTK_DEBUG=keybindings to
get some hints where key events get lost.

text: Give names to event controllers

It helps with debugging.

Merge branch 'wip/carlosg/sequence-state-fixups' into 'master'

Fixups to gesture sequence states

Closes #2895

See merge request GNOME/gtk!2154

gtktext: Don't accept (twice!) all press actions

The gesture should claim the sequence after triggering uncancellable
actions, like pasting, showing a menu or selecting words/lines. A
single first button press initiating a drag does not trigger
anything yet, so it should avoid claiming the sequence.

gtkswitch: Don't be eager in accepting the gesture

The gesture should be accepted whenever it triggers uncancellable
actions in the widget. This means it should be accepted if the
click does result in toggling the switch.

This leaves the pan gesture room to handle dragging the handle.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/2895

Merge branch 'matthiasc/for-master' into 'master'

main: Avoid a warning

Closes #2894

See merge request GNOME/gtk!2153

docs: Some tweaks to the list widget overview

Merge branch 'wip/otte/bitset' into 'master'

Improve selection handling API for rubberbanding

See merge request GNOME/gtk!2086

main: Avoid a warning

transient-for relationships only exist between
windows, so check that both candidates are such.

Fixes: #2894

Merge branch 'tintou/dropdown-annotations' into 'master'

dropdown: Annotate the get_selected_item method

See merge request GNOME/gtk!2152

Merge branch 'wip/ricotz/annotations' into 'master'

gtk: Add some g-i annotations to GtkStringList

See merge request GNOME/gtk!2150

dropdown: Annotate the get_selected_item method

We need to specify the type as we already know that it is at least a GObject and in case of no selection, NULL is returned.

listbase: Make rubberbanding a threshold drag

listbase: Only compute the modifiers when releasing the rubberband

... and do the right things:

nothing:    selection = rubberband
ctrl:       selection = selection OR rubberband
shift:      selection = selection AND (NOT rubberband)
ctrl+shift: selection = selection XOR rubberband
            (not sure this one makes sense, but toggling is fun)

listbase: Compute rubberband region on-demand

Instead of storing the active items as we go, compute the affected items
whenever the rubberband changes and in particular when the rubberband
ends.
That way, the rubberband is guaranteed to select a rectangle even
after scrolling very far.

This is achieved by having a get_items_in_rect() vfunc that selects all
the items in the rubberbanded rectangle and returns them as a bitset.

listview: Allocate rubberband at end of size_allocate()

Otherwise the rubberband uses the wrong scroll offsets.

listbase: Flip autoscroll deltas if adjustments are flipped

Fixes autoscroll on RTL languages.

listbase: Allocate gridview items properly on RTL

We need to flip the items.

multiselection: Implement get_selection_in_range()

listbase: Allocate rubberband according to list coords

The rubberband is now handled on the list coordinate system.

When starting the rubberband, we track the item under the pointer and
follow it when it is moving.
This may lead to the rubberband start position changing position and
while this may be confusing, it alerts users to the fact that something
crazy is going on.

listbase: Move a common function from the children into GtkListBase

We want to use it for the rubberband later.

listbase: Don't do extra work

Scrolling causes a queue_resize() which will update the rubberband in
size_allocate() and queue a draw.

Fix indentation

gtk: Remove GtkPropertySelection

GtkMultiSelection is so much faster than this that it isn't needed.

gtk-demo: Port listview-colors demo to multiselection again

multiselection: Track items across resorts

In particular, track which items remain in ::items-changed
signal emissions.

But the main use case is sorting, which causes items-changed(0, n, n)
to be emitted.

Remove GtkSet

It's been superceded by GtkBitset.

selectionmodel: Remove select_callback() functions

gtk_selection_model_set_selection() takes care of those now.

listbase: Port rubberband to gtk_selection_model_set_selection()

selectionmodel: Add gtk_selection_model_set_selection()

Also port the testsuite.

selectionmodel: Replace query_range() with get_selection()

multiselection: Port to GtkBitset

testsuite: Add tests for GtkBitset

Add GtkBitset

gtk: Add some g-i annotations to GtkStringList

Add amalgamated roaring bitmaps source code

Taken from https://github.com/RoaringBitmap/CRoaring and fixed to
not spew warnings.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2149

inspector: Adapt to dropdown api change

The suppported syntax for dropdowns in ui files
has changed. Get with the program.

docs: Fix a typo

gtk-demo: Fix a typo in the listbox demo

searchentry: Update the docs slightly

Update the docs to get closer to describing reality.

Drop unused includes

Don't include gtkfilechooserentry.h where it
isn't used.

stringfilter: Fix a typo

Update Turkish translation

Merge branch 'wip/carlosg/input-cleanups' into 'master'

Some input cleanups

Closes #2851

See merge request GNOME/gtk!2147

Merge branch 'scrolled-window-api' into 'master'

scrolledwindow: Don't take adjustments in new()

See merge request GNOME/gtk!2146

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2145

gtktextview: Remove child textview items last

The function tries to go through every child, so it's convenient
to remove all internal ones first.

gtkwidget: Drop _gtk_widget_[gs]et_shadowed()

This API is meaningless now, with grab-notify being handled internally.

gtkwidget: Avoid use of shadowed flag

This is going away, look up whether there is a grab, and whether
the widget is within it, instead.

gtkwidget: Drop gtk_widget_device_is_shadowed()

A widget no longer needs updating on GTK grabs on itself, drop
this miscellaneous and no longer used API.

gtkwidget: Drop internal checks in grab-notify

There's no need to check if the widget is already shadowed, we
implicitly have that from the signal argument.

gtkmain: Make grab-notify notifications more targeted

We only want to send grab-notify to widgets that might have been
interacting with devices via events. Instead of going through all
widgets in all toplevels, we have the window/pointer focus information,
so we can just traverse the widget stacks for every involved foci.

gtkwidget: Drop ::grab-notify signal and vfunc

We don't expect widgets to react directly to these anymore.
Internally we still reset the controllers.

gtkprintoperation-win32: Don't track grab-notify

Further grabs could presumably only come from events handled within
the dialog itself. It seems overeager to do this.

gtkvideo: Track child focus to determine whether controls should autohide

Move away from grab_notify, and use the set_child_focus() vfunc to track
child widgets being set the keyboard focus. This is not 1:1, but seems
good enough at the moment.

gtkbutton: Drop grab_notify handler

The click gesture already has a ::cancel handler, and does almost
everything it should. Move the last bits and remove the grab_notify
handler.

gtkspinbutton: Drop grab_notify handler

The press gesture on the buttons already has a ::cancel handler,
this is redundant.

gtknotebook: Move away from grab_notify

Connect to ::cancel on the relevant gesture instead.

testgtk: Update list of cursor names

Use the standard names, since that is what we want
everybody else to use too.

Install gtkstringlist.h

entrycompletion: Various fixes

Fix various issues that prevented inline completion
and inline selection from working reliably. We were
passing byte counts to gtk_editable_select_region in
one place, but that function expects char counts.
We were listening for GtkEditable::insert-text on
the GtkText widget, but that does not emit those signals,
so listen for GtkEntryBuffer::inserted-text instead.
Finally, we were not clearing the stored completion_prefix
enough, leading to situations where the stored prefix
does not match the text in the entry anymore.

gtk-demo: Enable inline completion

Enable inline completion in the entry completion
demo, to have some code exercising this feature.
It is broken.

gtk-demo: Improve the entry completion demo

Add more strings.

scrolledwindow: Don't take adjustments in new()

In 99.9% of all cases, these are just NULL, NULL.
So just do away with these arguments, people can
use the setters for the rare cases where they want
the scrolled window to use a different adjustment.

gtkwindowhandle: Drop has-grab checks

While it's worth thinking about bringing the "windows can be dragged
with open popovers" behavior back, this does not kick in anymore, nor
should be the way to handle this given all the autoclose surface
semantic changes.

gdk: Drop gdk_device_get_last_event_surface()

This kind of transient state sets the expectative that events update
devices, while it's more accurate to say that devices generate events.
It does not make to expose this function anymore.

gtkwidget: Avoid poking surfaces and events in gtk_widget_list_devices()

This got stuck in ancient times when widgets were windowed, so the devices
in a window to know the devices in that widget would pan out. We do only
want here the devices that are inside the widget, not spread over the
surface, so rewrite this helper function to poke the toplevel foci, and
look they are contained inside the widget.

gtkwidget: Drop _gtk_widget_get_device_surface()

A widget cannot have multiple surfaces anymore, nor needs to
fetch the last event surface as it ought to handle its own.

gtkmain: Drop unused struct field

Grabs are, ironically, not about devices anymore. This struct field
is never set.

gtkwidget: Remove dead code

This variable got unused over time.

gdk: Depend less on gdk_event_get_device()

For the most part, we are interested in seats here.

gdk: Add gdk_event_get_seat()

It currently fetches the seat from the event device, will be changed
in future commits.